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BEFORE 
USING 
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PROGRAM! 


This APX diskette is unnotched to protect the software against 
accidental erasure. However, this protection also prevents a program 
from storing information on the diskette. The program you’ve purchased 
involves storing information. Therefore, before you can use the 
program, you must duplicate the contents of the diskette onto a notched 
diskette that doesn’t have a write-protect tab covering the notch. 


. To duplicate the diskette, call the Disk Operating System (DOS) menu 
and select option J, Duplicate Disk, You can use this aption witha 
single disk drive by manually swapping source (the APX diskette) and 
destination (a notched diskette) until the duplication process is 
complete, You can also use this option with multiple disk drive systems 
by inserting source and destination diskettes in two separate drives 
and letting the duplication process proceed automatically. (Note. This 
aption copies sector by sector. Therefore, when the duplication is 


complete, any files peviously stored on the destination diskette will 
have been destroyed, 
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Introduction 


OVERVIEW 


DRAWIT is exceptional among the-drawing programs available for 
ATARI Home Computers because of its well chosen, easy-to-use 
features. It can turn your creations into a "slide show" (for 
which you control the timing) and an automatic message cycling 
system, 


The cassette or diskette actually contains two programs! 
DRAWIT allows you to create and save your drawings, and 
ANIMATOR brings them to life. With ANIMATOR, you can list 
commands to add motion and special effects to your pictures. 


With 48K of computer memory, you can create up to nine pages of 
multicolored drawings in memory at a time} with 16K of memory, 
you can create one page, and with 32K of memory, you can create 
five pages. Using four color pens, you can choose from sixteen 
different colors and eight different hues. You can easily draw 
outlined and solid circles, lines, boxes, different sized text, and 
freehand sketches. DRAWIT also has a fill feature, along with 
design relocation, page merging, and two zoom levels for detail 
work, The program comes with three quick reference pages you 
can load into memory (if you have the appropriate amount of 
minimum memory) and use for handy recall while you’re working. 
You can store pages on either cassette or diskette and recall 
them at a later time. 


You can use your drawings in several ways. For example, 
DRAWIT includes a program that lets you incorporate your 
drawings into BASIC programs. And with ANIMATOR, you use a 
simple set of commands to combine pages in imaginative ways, 
such as fading one page into another, creating page wipes from 
any of four directions, displaying pages in any order with your 
Own specified time delay, and repeating any of these features, 
You can turn your ATARI Home Computer into a visual aid for 
presentations or into an automatic sales or demonstration 
devices DRAWIT also includes an animation demonstration. 
You'll really enjoy experimenting with this program! 


REQUIRED ACCESSORIES 
One ATARI Joystick Controller 


Cassette version 


16K RAM 
ATARI 410 Program Recorder 


Diskette version 
16K RAM 
ATARI 810 Disk Drive 
OPTIONAL ACCESSORIES 


ATARI BASIC Language Cartridge 


CONTACTING THE AUTHOR 
Users wishing to contact the author may write to him at? 


1528 Bertram St. 
Honmolulu, HI 96816 


or telephone him at: 


BOB/737-9976 


ACKNOWLEDGMENTS 


My thanks to Tad James and DATA-~1 for use of their equipment. 
And special thanks to Randy Isaki for use of his equipment and 
help in writing the manual. 


Getting started 


LOADING DRAWIT INTO COMPUTER MEMORY 


1, Remove any program cartridge from the cartridge slat of your 
computer. 


2. Plug your Joystick Controller into the first controller jack of 
your computer console, 


Note. DRAWIT is actually two separate programs. You use 
DRAWIT to create pictures, and ANIMATOR to add motion and 
Special effects. With the diskette version, you make your choice 
from a menu; with the cassette version, you must load either one 
program or the other. 7 


a. Have your computer turned OFF, 
b. Turn on your TV set, 


c. Insert the DRAWIT cassette into the program recorder’s 
cassette holder and press REWIND on the recorder until the 
tape rewinds completely. Set the tape counter at zero, Then 
press PLAY to prepare the program recorder for loading the 
program. 


d. Turn on the computer while holding down the START key. 
e. When you hear a beep, release the START key and press 
the RETURN key. The program will load into computer 


memory and start automatically. 


f, Make a note of the new tape counter setting. This number 
is the beginning of the ANIMATOR program. 


g. To load the ANIMATOR program now, turn your computer 
OFF, 


h, Press PLAY to prepare your program recorder to load the 
program. 


i, Turn on the computer while holding dawn the START key. 


je When you hear a beep, release the START key and press 
the RETURN key. The program will load into computer 


memory and start automatically. 


Note. In the future, you can load ANIMATOR without having 
to load DRAWIT first. Have your computer turned OFF, and 
turn on your TY set. Insert the cassette in the program 
recorder and press REWIND. Advance the tape to the number 
you recorded in step F, above, and press PLAY. Turn on the 
computer while holding down the START key. When you hear 
a beep, release the START key and press the RETURN key. 
The ANIMATOR program will load into computer memory and 
start automatically, 


a, Have your computer turned OFF, 

b. Turn on your disk drive, 

c. When the BUSY light goes out, open the disk drive door 
and insert the DRAWIT diskette with the label in the lower 


right-hand corner nearest to you. Close the door, 


d. Turn on your computer and your TV set. The program will 
load into computer memory and start automatically. 


THE FIRST DISPLAY SCREEN 


When the program has loaded into computer memory, the 
following screen appears if you have the diskette version! 


MENU 
1 DRAWIT 
2 ANIMATOR 
3 DIRECTORY 
ENTER SELECTION? 


Figure i First display screen 


If you have the cassette version, the title, copyright, and 
author’s name appear. 


DRAPRIT screen 


If you have the diskette version, type 1 to see the title, the 


copyright, and the author’s name. Then (in both cassette and 
diskette versions) the following screen appears: 


Figure 2 Drawing screen 
The plus sign in the middle of the screen is the cursor, 


The top band of the drawing screen is called the "status window." 
It shows the information you need to develop your drawings. 


The first set of coordinates (the capital X and Y at the left) 
indicate the vertical column and horizontal row position of the 
cursor you control, 


The second set of coordinates (the lower case x and y) show the 
column and row of the “lastpoint". This term means a marker of a 
position that you’re going to connect to the position of the 
flashing cursor, For example, you might draw a line between the 
lastpoint and the flashing cursor, 


The # sign shows the number of the “pen” you’re using. It’s set 
at 1, but you can change it to 0, 2, or 3 as you use the program. 
Refer to the section on "Pens, colors, and intensities”, 


The letter C stands for the color. "Orng” in Figure i is an 
abbreviation for "orange." Type the letter C repeatedly to see 
the many color changes available. 


The letter I denotes the intensity of the color. Type the I key 
repeatedly to see the variations. , 


The number beside the letter P is the number of the "page" (the 
screen) you’re currently using, The numbers range from 1 to 9 if 
you have 48K of memory. (If you have 40K, you’re limited to 7} if 
you have 32K, you can use 5} with 24K you can use 3; and with 
16K you can use only one.) 


Cursor control 


JOYSTICK MOVEMENT 
Use your joystick to control the movement of the cursor, For 
very fine control, hold down the CTRL (CONTROL) key and press 
the arrow keys, 


CHANGING THE CURSOR 


There are three ways to display the cursor while you work on 
DRAWIT: 


Press + to select a cross as the cursor and a dot as the 
lastpoint. 


Press * to select a dot as the cursor and another dot as 
the lastpoint. 


Press } to turn the cursor and the lastpoint off, 


CURSOR SPEED 
Type Q (for "quick") to have the joystick move the cursor rapidly. 


Type S to have the joystick move the cursor slowly, 


Pems, colors; and intensities 


PENS 


To create a picture, you first select a"pen." This is the medium 
for your artwork. You’re determining the background color and 
intensity for the setting, and the color or colors for the figures 
and letters you impose on the background. 


You can draw with any one of four pens, numbered from 0 through 
3. The program is set for Pen 1, but you can type 0, 2, or 3 to 
change it. When you select a new pen, you see a new color and 
intensity in the status window. You can change these, too. 
Whenever you return to the pen with that number, the color and 
intensity you chose appear automatically. 


Since Pen 0 is the background color, you can set the pen to 0 to 
change your background. You can set different colors for Pens 
1,2, and 3 to draw a four-color screen. If you don’t reset the 
pens, Pen 0 is a low intensity of gray, almost black} Pen 1 is 
orange} Pen 2 is green, and Pen 3 is light blue. 


COLORS 


Type C repeatedly to select the color of the pen you’re using. An 
abbreviation of the mame of the color appears in the status 
window, The quick reference sheet section, later in this manual, 
lists all the colors. 


INTENSITY 


Type I repeatedly to select the intensity of the pen. Different 
intensities give fine variations to each of the colors you've 
selected. The intensities are numbered from 0 through 7. 


You can choose from over one hundred colors by selecting 
different color and intensity combinations. 


Drawing commands 


SETTING THE LASTPOINT 


To draw a line, box, or circle, you must establish a lastpoint at 
some distance from the flashing cursor. To do this, move the 
flashing cursor to the place where you want the lastpaint to be. 
Type U to set the lastpoint right under the flashing cursor. As 
you move the cursor away from that spot, you see a dot blinking 
on and off in its place. The blinking dot is the lastpoint} its 
coordinates appear in the status window (as lower case x and y), 


Move the cursor about the screen and type U several times. Each 
time you type U, the lastpoint is moved (or “updated") to the 
cursor position, and the previous lastpoint disappears from the 
screen, 


You can also press the red joystick button to update the 
lastpoint. This is different from typing U, because this way you 
draw a single dot on the screen, 


Move the flashing cursor to a new place and update the lastpoint 
again. If you typed U, above, the original lastpoint disappears, 
If you pressed the joystick button, the dot you drew remains on 
the screen, even though the lastpoint has been removed from that 
spot. 


Tf you use the line, box, or circle commands (described below), the 
lastpoint is automatically updated. 


DRAWING FREEHAND 


To do freehand drawings, hold down the joystick button while you 
move the cursor around with the joystick. As long as you hold the 
button down, the lastpoint will be updated with the cursor 
position continuously, 


CLEARING THE SCREEN 


To clear the screen of all your drawing, hold down the SHIFT key 
and press the CLEAR key. You see only the background color on 
the screen. This only clears the page that’s currently on the 
screen; it doesn’t affect other screens in memory, 


nas 


DRAWING LINES 


To draw a line, move the flashing cursor to a point on the screen 
that you want to be one end of the line. Press the joystick 


button or type U to set the lastpoint (LP), as in Part A of the 
diagram below, 


Note. If nothing seems to be happening, check to be sure 
you’re not drawing with the same color pen as the 
background, 


FO (FC) (LP) 


* (LP) (LP) (FC) 


A B C¢ 
Figure 3 Drawing 2a line 


Then move the flashing cursor (FC) to another position (the other 
end of the line). Type L, and the program draws a line from the 
lastpoint to the flashing cursor, as in Part B of Figure 3. 


After drawing a line, the program updates the lastpoint to where 
the flashing cursor is. To draw a connecting line, move the 
flashing cursor to a new position and type L, as in Part C of 
Figure 3. 


DRAWING A BOX 


To draw a box, move the flashing cursor to a point on the screen 
that you want to be a corner of the box. Type U or press the 
joystick button. Then move the flashing cursor to another point 
on the screen: wherever you want the diagonally opposite corner 
of the box to be, as in Part A of the following diagram: 


Peiigs 


" (FC) (FC) 
+ 


“(LP) LP) 


A B 
Fiqure 4 Drawing 3 box 
Type B and the program draws a box. The pasitions of the 
lastpoint and the flashing cursor determine the length and width 
of the box, as in Part B of Figure 4. 
To draw a solid box, hold down the CTRL (CONTROL) key while 
typing B. 


DRAWING CIRCLES 
Position the flashing cursor at a point on the circumference of 
the circle you want to draw. Type U or press the joystick button 


to set that point as the lastpoint. Move the flashing cursor to 
the center of the circle, as in Part A of the following diagram: 


(LP) . (LP) 


FEC) 


Figure S Drawing @ circle 


Type O and watch the program draw a circle, The radius is the 
distance between the flashing cursor and the lastpoint, as shown 
in Part B of Figure 5. 


To draw a solid circle, hold down the CTRL (CONTROL) key while 
you type 0, 
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FILLING IN A FIGURE 


Draw any outlined shape, making sure it’s completely enclosed, 
and it contains no dots of the same color. Position the flashing 
cursor inside the figure, as in the following diagram! 


(LP) 


A 
Figure 6 Filling in 3 figure 


Type F and the program fills in the enclosed figure, Press the 
SPACE BAR to interrupt the fill process. 


Note, Make sure that the color you’re using to fill in the 
figure is the same as the color of the outline itself, 
Otherwise, bands of color just sweep across the borders 


of the screen. (If this happens, press the SPACE BAR to 
stop the bands of color.) 


Also make sure that inside the figure there are no dots or 
points of the same color as the outline. Again, the color 
starts filling in from the borders of the screen. Press 
the SPACE BAR to stop it if this happens. 


RELOCATING A SCREEN 


This function allows you to move a figure you’ve drawn to a 
different screen position, 


First, update the lastpoint on the figure you want to move. Then 
move the flashing cursor to the new position, as in the following 
diagram: 


-11- 


Figure 7 Relocating 3s screen 


Type R to move the figure marked by the lastpaint to the place 
marked by the flashing cursor. Part B of Figure 7 shows a figure 
in its new position by the flashing cursor, 


Actually, the entire screen moves to position the lastpoint under 
the cursor. If a part of the drawing moves off the screen to the 
top, it "wraps around” to appear at the bottom} likewise, if it 
moves off the left of the screen, it reappears at the right. 


SELECTING SCREENS 


Each drawing fills a “page” on the screen. Type P whenever you 
want to turn the page, or change to another picture, The amount 
of memory you have determines how many pages you can fill, as 


follows} 

48K - 9 screens 
40K - 7 screens 
32K - S&S screens 
24K ~- 3 screens 
16K - 1 screen 


For each page, you select a pen, a color, and an intensity, and 
then begin drawing your picture. Suppose you draw a picture on 
page 1, then type P to go ta page 2. Whenever you type P enough 
times to return to Page 1, your pen choice and picture reappear 
on the screen. 


MERGING SCREENS 


This option allows you to merge one screen (or page) of drawing 
under another, if you have enough memory to hold more than one 
screen (24K or more). First, select the screen you want to merge, 
Type P (for page) until it appears, and then type M to mark this 


212+ 


200M 


screen, 


Note. The screen doesn’t change to show that you’ve 
marked it. 


Type P again to select a screen to merge the first one into, 
Choose the background color of the second screen by typing its 
pen number (usually 0) This color will be "painted" with the 
pattern of the first screen you marked, 


Hold down the SHIFT key and press the INSERT key to merge the 
first under the second screen, 


Note. While you’re learning how to merge screens, it’s 
easy to lose a picture. It’s a good idea to first save the 
screen you’re merging. See the section on saving screens 
later in this manual, 


You can create some interesting effects with the merge option as 
you grow more familiar with it. Try using pen numbers other 
than zero. 


DRAWIT’S two-level zoom lets you view your drawing up close. 
This feature is helpful when you’re drawing intricate patterns, 
and you need to examine each dot on the screen, 


Type Z to select the next zoom level. You can do all the same 
things (such as drawing circles and relocating screens) at each 
level. To return to the first level, type Z again. 


In the zoom mode, the cursor is a large, flashing dot, and you 
don’t see the lastpaint. Press the + key to bring back the cursor 
you usually see, Press the } key to turn it off. 


WINDOW TOGGLE 


You can turn the status window off and on by typing W. There’s 
a separate status window for each zoom level. If you turn the 
status window off for one level, and then zoom the status 
window will be on for the next level. 


Note, To see your design clearly, type ; to turn off the 
cursor, and W to turn off the status window, 


DRAWING LETTERS AND CHARACTERS 


You can display many sizes of text on the screen-~tall, thin 
letters to short, wide ones. 


Move the flashing cursor to the approximate position of the 
upper left corner of the letter. Update the lastpoint, and move 
the flashing cursor down to the lower right corner of the letter, 
as in the following diagram: 


(LP) CLP) 


FO I : a _I|_ 


Figqure 8 Drawing letters 


Press the OPTION key. The cursor stops flashing. Type some 
letters on the keyboard. The program draws letters as close as 
possible to the size of the dimensions you chose, 


Note. If the size of the letter exceeds the width of the 
screen, the program returns to the drawing mode (as you 
can see from the flashing cursor). Follow the steps above 
again, but this time, make the dimensions of the letters 
smaller, 
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Saving and loading screens 


SAVING A SCREEM 
Cassette version 


Type K (far "“keep") and the following prompt appears in the 
status window? 


KEEF FILENAME C? 
Press the RETURN key. The computer will beep twice, Then 
position the tape and press PLAY and RECORD on the program 
recorder. Press the RETURN key again. 


Diskette version 


Type K (for “keep") and the following prompt appears in the 
status window} 


KEEP FILENAME D113 


0 ome ee coe 


If you’re using one disk drive, remove the program diskette and 
insert a blank formatted diskette. Then type a name for your 
screen and press the RETURN key. 


If you’re using two disk drives, press the DELETE BACK S key to 
erase the 1! in the status window. Type 2! instead, so that your 
entry begins with D2! Then type the name of your file and press 
the RETURN key, 
Note. Press the DELETE BACK §S key to erase any typing 
errors before you press the RETURN key. 
10 
LOADING A SCREEN 


Cassette version 


To load a screen that you’ve stored, type G (for “get") and the 
following prompt appears in the status window: 


GET FILENAME C$ 


If you’re using a cassette, press the RETURN key. The computer 
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will beep once. Then position the tape and press PLAY on the 
program recorder. Press the RETURN key, 


Diskette version 


To load a screen that you’ve stored (ar one of the screens the 
program has available), type G (for "get"). The following message 
appears in the status window: 


GET FILENAME Dito 
If you’re using one disk drive, and your file is stored on another 
diskette besides the program diskette, remove the program 
diskette from the disk drive. Insert the diskette that contains 
your file. Type the name of your file and press the RETURN key. 


If you’re using two disk drives, insert the diskette containing 
your file into disk drive two, and close the door. Press the 
DELETE BACK § key to erase the 1! and type 2% so that your 
entry begins DZ! Type the name of the file and press the 
RETURN key. 


Special reminders 


Suppose you’ve loaded one screen into memory and you want to 
load a second screen. Make sure to type FP to get to another page 
before you load the second screen. Otherwise, you erase the one 
you loaded first, 


SAMPLE SCREENS 


The diskette version of DRAWIT includes many sample screens. 
You can load them into computer memory just like the files you 
create, 


Type G. When the program prompts you to type the file name, 
type a file name like one of the following! ELEPHANT, DOLPHIN, 
BALDM, and CASTLE. (If you’re using two disk drives, press 
DELETE BACK S to erase the 13 and type 2% before you type one 
of the file names.) 


It’s a good idea to use these screens to experiment with 
DRAWIT. ANIMATOR uses many of these drawings too. Try 
loading them into memory and using some of the program’s 
special effects on them, 
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MENUS 


There are three “menus” of information included in the diskette 
version of DRAWIT. Refer to them when you need a reminder 
about the functions of different keys. The same information 
appears on the "Quick reference sheet" later in this manual, 


The file names of the menus are MENU1, MENU2, and MENU2, 
Load them into computer memory using the procedure above 
{beginning with typing G). 


If you load one of these menus into each of three of the pages in 
the program, you can refer to any one easily by typing P until it 
appears on the screen, 


Note, If you have i6K of computer memory, you can only 
have one screen in memory at a time. 
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Advanced technical 
information 


USING DRAWIT SCREENS FROM BASIC 
You can display the screens you create in DRAWIT in a BASIC 
program, Follow the steps to save your screen on diskette or 


cassette, (Begin by typing K.) 


Then bring up BASIC in the usual way. When the READY prompt 
appears, insert the DRAWIT diskette, and type the following: 


LOAD "DISCREEN" 
Press the RETURN key. 


If you have the cassette version of DRAWIT, you must type the 
program on the next page, 


Now type LIST to look at the program. The machine language 
routine is called at line 10040, Make sure to meet the following 
conditions: 
1, The Graphics 7 or 7 + 16 screen must be up. 
2. The second argument of the user function must be the 
address of the valid filename ending with a CRETURNI 
character (CHR$(155)). 


The routine uses control block #5 to load the screen and the 
color registers. 


The sample BASIC program will load the three menus, ane on top 
of the other, and loop infinitely at line 1980, 
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19 REM # BASIC SCREEN LOADER PROGRAM 


11 REM « BY JAMES BURTON 
12 REM x 01/07/83 

13 REM ! 

14 REM 


20 REM INITIALIZE 

30 FOR 124.5"256 TO 4.5"254+87 

40 READ D 

50 POKE 1,0 

60 NEXT I 

70 DATA 104,142,980 5159%, 4515747473169 91285157 5759391044157 597341045157 768, 3,169 
23.157,66,3,32,86,228,149,7 

80 DATA 157,66,3,1465,88,157,68.3,1465,89 157 594 3,169, 0,157 5724 39169915417 7A e Dy 
32,96,228,149,196,157,48,3 

90 DATA 1469,2,157 559 239159 559157 57293916950 157 173939329 8Gs 228 LHF 9125157 555,357 
6,846,228 

95 REM 

100 OTM NAMES(15) 

11@ GRAPHICS 7+14 

120 REM wxxuxx YOUR CODE wuuxxuxxuxx 

130 FOR I=1 To 3 

140 READ NAMES 

150 GOSUB 10000 

140 NEXT I 

170 DATA OS MENUL,O2MENU2,D?MENUD 

180 GOTO 180 

190 REM ! 

10080 REM maxx SCREENLOAO xxux 

10010 REM 

10020 NAMES (LEN(CNAMES) +1) #CHRS(155) 

10040 A*USR( 4.52256, ADR (NAMES) ) 

10050 RETURN 


19 


SPECIAL NOTES 
The BREAK key is disabled. 


Tf you have the cassette version, pressing the SYSTEM RESET 
key returns you to page 1. 


If you have the diskette version and you have the program 
diskette installed, pressing the SYSTEM RESET key returns you 
from DRAWIT to the first menu (Figure 1). If you want to go to 
DOS instead, you must insert a formatted diskette into the disk 
drive with the following files on it! 


DOS.SYS 
DUP.SYS 
MEM.SAV 


Then press the SYSTEM RESET key. 
To return from DOS to DRAWIT, select M from the DOS menu and 
press the RETURN key. Then type 2000 and press the RETURN 
key. 

. Note, In all cases pressing the SYSTEM RESET key 


causes the operating system to build a Graphics 0 screen, 
which wipes out the bottom 1/4 of the last screen, 
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Quick reference sheet 


COMMANDS 


NECMHFPOVOORCTAHONONODRONrO 


CTRL CUP) 
CTRL (DOWN ) 
CTRL (LEFT) 
CTRL (RIGHT) 
SHIFT CLEAR 
SHIFT INSERT 
OPTION 


e 


? 
+ 
x 


Per #0 

Pen #1 

Fen #2 

Fen #3 

Outlined box 
Solid box 

Change pem color 
Fill ares 

Get picture 
Change intensity 
Keep picture 
Draw line 

Mark page 
Qutline circle 
Selid circle 
Fage flip 

Quick cursor movement 
Relocate picture 
Slow cursor movement 
Update lastpoint 
Wiridaw toggle 
Zoom 

Fine move up 
Fine move down 
Fine move left 
Fine move right 
Clear page 
Insert backeround 
Draw letter 

No cursor 

Cross cursor 

Dot cursor 
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COLOR SELECTIONS 


Greyeres Grey 
Gold...+.Gold 
Orng...-+-Orange 
Redss+eesRed 
PirikeseoePink 
FurpeeeeeFurple 
PuBleseeeFurple blue 
Bluee.6s Blue 
Blue@eese Blue 

LE lusseeeLight blue 
Turgeses es Turquoise 
GrBl....-Green blue 
Grrieeses Green 
YOrrieoseeeYellow green 
OGrriees+-sOrange green 


LOrng..-+eLight orange 
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Using ANIMATOR 


SPECIAL EFFECTS 


ANIMATOR lets you display your drawings with special effects. 
You can fade pages into one another, sweep pages over one 
another in four directions, display them in any order with time 
delays, and repeat any of the special effects as many times as 
you like, 


SELECTING ANIMATOR 


The loading instructions in the "Getting started" section earlier 
in this manual show you how to load ANIMATOR into computer 
memory from a cassette, If you have the diskette version, you 
can press the SYSTEM RESET key to return from DRAWIT to the 
first display screen (Figure 1), Then type 2, 


The program displays the following choices on the diskette 
version} 
ANIMATOR 
(C)1983 JAMES BURTON 
RUN 


FORMAT 
DOS 


Ihe 


ENTER SELECTION? 


Fiqure 9 ANIMATOR menu -—- Diskette 


The cassette version of the ANIMATOR menu is shorter, as 
follows: 
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ANIMATOR 
(C1983 JAMES BURTON 


1 RUN 
2 FORMAT 


ENTER SELECTION? 


Figure 10 ANIMATOR menu - Cassette 


RUNNING THE DEMONSTRATION 


If you have the diskette version, you can type 1 to see thea 
demonstration of the program. First a title screen appears, with 
a hand holding a pen and painting the words DRAW IT on the 
screen. Then a tune plays and the following screen replaces the 
title! 


SALES 
DEMO 
SLIDESHOW 


PRESS ANY KEY OR 
THE JOYSTICK TRIGGER 
TO SEE EACH SLIDE 


Will repeat 3 times 
Figure ii ANIMATOR demonstration 


When you follow the instructions to press any key or the red 
joystick button, a bar graph entitled “Monthly Sales Si" appears. 
Press another key or the red button again; and a new bar graph 
appears, this time the monthly sales for 82. The third bar graph, 
monthly sales for 33, shows discouraging sales but imaginative 
graphing. The display of these three graphs repeats three times 
as you continue to press keys or the joystick button. 


Next different graphic screens fade into each other, and pages 
sweep from all four directions so that you can see everything 
ANIMATOR can do. 

When you’ve seen enough, press the BREAK key. The program 
returns to the ANIMATOR menu (Figure % or 10), 
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FORMATTING A FILE 


After you’ve seen all of ANIMATOR’s special effects, you’re 
ready to carry them out on some of your own screens. Before you 


do, you must have some screens stored on a cassette or diskette 
file, 


To use ANIMATOR, you create a file of commands to program the 
effects you want. You can create this file using most ward 
processors (such as AtariWriter) or assemblers. You can also 
create it directly from ANIMATOR by selecting the format 
option, The advantage to using the word processor or assembler 
is that you can return to a line to edit it. 


Type 2 to select the FORMAT option. The screen is blank except 
for the word "FORMATTER" at the top. You write a list of the 
commands ANIMATOR uses to bring your screens to life. The 
Sample Format File, below, is a list of all the commands used to 
make the demonstration (Option 1 from the ANIMATOR menu) 
YUN 


Warning. When you finish listing your commands, enter a 
blank line. The program then writes your instructions to 
the diskette or cassette. With the diskette version, the 
file name will be FORMAT.SYS. Make sure you've 
removed the program diskette or cassette, and inserted a 
blank one, before you enter that blank line. Otherwise, 
you could erase an important part of the program itself, 


Tf you have the cassette version, prepare your cassette 
before you type that blank line. Insert your cassette and 
position the tape. Record the number of the tape setting. 
Press PLAY and RECORD. Then press the RETURN key 
twice, The program saves the commands on the cassette, 
Record the number of the tape setting again. The program 
returns to the ANIMATOR menu (Figure 10), 


In the following guide to the commands, note that a lower case p 
stands for the page number (from 1 through 9 if you have 48K of 
computer memory, fewer screens if you have less), When you see 
the lower case p in the command, replace it with the number of a 
page. 


Note that lower case nn stands for any integer number from 0 
through 255, 
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Use the following commands. The explanations refer to the line 
numbers in the Sample Format File. 


Cc 


Fp 


Gpe"Difilename 


I'Difilename 


Clear current page. 
Generally begin a list of 
commands (other than the }; 
command) with this one, 
See line 40. 


Fade page p onto curremt page. 
Line 530 shows a fade 

command applied to page 3. 

You cam write the word out 

as im line S20. 


Get into page p from 
Difilename 

Type the name of a file 
you’ve stored on 3a diskette, 
For 8 cassette, just type Ci 
im place of Difilename. 

Be sure the pages are in 
the order you want on 

your cassette, 

Line 470 shows 2@ command to 
Get the file entitied 

LOGO from the diskette. 


Run another list of commands 
(with another file name 

besides FORMAT.SYS) 

This must be the last command 
im 8 command list. 

(Any commands following 

this one will mot be executed.) 


dump to the start of the 
command file. 

Line 640 shows &@ jump. 

This means the program 
starts over again and again. 
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N 


Pp 


Rim 


Music. 

Type M, tempo, mote value, 
mote value, ete. 

Tempo is the duration of 


eech mote in ticks, and ranges 


from 0-255 

(a tick is 1/60 second). 
(0 means 256), 

Note values are numbers 
from 0-256, giving the 
pitch. (See the BASIC 
Reference Manual.) 

Line 270 shows music 
with a tempo of 7 and 16 
notes, 


Next repeat. 

This is the end of a loop 
bequn by R below. 

Line 310 begins a loop that 
ends om line 360. 


Display page p after 
delaying ane tick 

(a tick is 1/60 second), 
This makes 2 very small 
adjustment in the speed 

of your display. 

Line 190 shows 3 F command, 


Repeat mm times everything 
between this line and the 
next unmatched N command. 
Line 360 begins a loop that 
ends at line 430, 


It’s repeated 3 times. 


If you type 0 in place of 
mm, the program will just Qo 
om repeating. 

Repeats cam be nested 

30 times, 

Lines Si0 through S40 show 
one loop nested inside 
another (500 - 6303 
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Snir 


Thin 


Vp 


Ap 


<p 


Deley mm seconds. 

You can’t type a 0 here. 
This pauses your display. 
Line 230 shows 38 command 
to deley. It makes mo 
difference if you type a 
whole word before entering 
the mumber,. 


Delay nm ticks (nm can’t 
be 0). 

A tick is 1/60 second. 
Lime 170 shows 3 delay 
of one tick. 


Wait for wser to press 

a key or the red joystick. 
button. 

The program beeps 85 8 cue. 
Line 380 shows a wait. 


Sweep page p omto the 
current page from top 
to hottom. 

Line 580 is an example, 


Hold down the SHIFT key and 
type x 

Sweep page p onto the 
current page from hottom 

to top, 

See line 600. 


Sweep page p onto the 
current page from left 

to right. 

Line 610 shows an example. 


Sweep page p orto the 
current page from right 
to left. 

See line 390 
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Comments only, having mo 
effact on the programs 
Line 10 is am exemple. 


+ 


The sample format file follows on the next two pages. 
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10 5 SAMPLE FORMAT FILE 

- ’ 

30 PL 

90 Clear screeneeesee 

SO Gi “OSTITLE.1" ;LAST QUOTE OPIONAL 
60 G2 “OS TITLE.2 

70 Sanytning can come between 

80 j;the "G" and the "3" in the 

90 ;line below. 

0190 Get into page 3 “DITITLE.3 
0110 G4 “OI TITLE.4 

6120 GS “OSTITLE.S 3} COMMENT 

0130 ; 

0140 R10 --For I=1 TO 10-- 

0150 Pi 

0160 R60 tthese three lines are 
0170 T1 sequivalent to Si 

0180 N $¢60 TICKS=1 SECOND) 


0190 2 

0200 P3 

0210 P4 

Q220 PS 

0230 Seconds 1 WAIT ONE SECOND 
0240 Next I --- SAME AS “N'---- 
0250 3 


0260 Music! tempos7, notes are 
72,72,60,60,81,81,60,60,91,91,72,72,81,81,81,81,91,91 
0270 M7 
91,81,96,96,121,121,108,108,128,128,121,121,121,121,121,121 
a280 ; 

0290 P1 $look at page one 

60300 C jthnen clear 

0310 Gi "“O?SALES.MES 

0320 G2 "D:SALES.81 

0330 G3 “DSSALES.82 

0340 G4 “O3SSALES.863 


0350 Wait 

0360 R3 3 tines 
0370 P2 “81 
0380 WwW ait 

0390 P3 82 
0400 WwW ait 

0410 P4 *83 
0420 WwW 

0430 N 

0440 3 
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0450 
0460 
0470 
0480 
0490 
0500 
o5i0 
0520 


0530 
05490 
0550 
0560 
0570 
0580 
0590 
0600 
04610 
0620 
0630 
0640 


Pt 3;FADE & WIFE ONTO PAGE 1 

Cc 

G2 “OsLoco 

G3 “OSCIRCLE 

G4 “OSCIDER 

Repeat 3 times (outside loop) 
RS (inside loap) 
Fade 2 --logo 


F3 --circle 

F4 ~-cider 

FS ~-title 
N (end inside loap) 


RS (second inside loop) 


<3 --wipes-- 

a4 

>5 

N {end of inside loop) 
N (end of autside loop) 


J ump to start and repeat forever 
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You can type anything between the command character and the 
number value} the program just ignores it. Line 230 could have 
been typed as Si. 


If you type a command that’s invalid or a number value that’s out 
of range, you hear a beep that signals an error. It doesn’t stop 
the program from running. At the end of the commands; you 
return to the ANIMATOR menu. 


Press the SYSTEM RESET key to go ta the DOS menu. 


Suppose your computer has less than 48K of memory and you can’t 
use all nine pages. If you write a command that includes a 


number you can’t use, the program just displays static on the 
screen. 


The maximum length of a format file is about 2,000 bytes. You 
could destroy a screen if you exceed this amount. Use the lI 
command if you want to incorporate more files. 


After you’ve written all the commands and saved them on the 
diskette (in a file named FORMAT.SYS), or on the cassette, 
select the RUN option and you see your animated screens 
carrying out the commands you wrote, 


USING DOS TO LIST YOUR COMMANDS 


If you have the diskette version, you can list the commands 
you've written by using the DOS menu. First return to the 
ANIMATOR menu (Figure 9), Before making a choice, remove the 
Program diskette from the disk drive and insert another diskette 
that contains the following files: 


DOS.SYS 
DUP .SYS 
MEM.»SAV 


Type 3 to see the DOS menu on the screen. Select “Copy” by 
typing C. The following prompt appears: 


COPY--FROM, TO? 
Type these instructions: 


FORMAT. SYS,;Ss 
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The list of all your commands begins on the screen, 


EDITING YOUR LIST 


Typing errors can be a problem, since you can’t go back and 
change a list of commands when you’re in the FORMAT option. 
But you can use ATARIWRITER, the ATARI Editor Assembler 
Cartridge, EASMD, Text Wizard, or MAC45 to edit the 
FORMAT.SYS file. Use any one of these editors to create your 
format file, 


ANIMATOR ignores line numbers before a command, 


When you save the file, use FORMAT.SYS as the file name. 
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Using the directory 


If you have the diskette version of DRAWIT, you can request a 
list of all file names. When you see the menu on the first 
display screen (Figure 1), type 3. 


The program lists the files. At the bottom of the screen, you see 
this message! 


ANY KEY FOR MENU 


Press any key to return to Figure 1. 
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7 QO ATARI! Program Exchange 
A P.O. Box 3705 
x Santa Clara, CA 95055 


We're interested in your experiences with 
APX programs and documentation, both fa- 
vorable and unfavorable. Many of our authors 
are eager to improve their programs if they 
know what you want. And, of course, we want 
to know about any bugs that slipped by us, so 
that the author can fix them. We also want to 


1. Name and APX number of program. 
_Drawit (209) 


Review Form 


know whether our instructions are meeting 
your needs. You are our best source for 
suggesting improvements! Please heip us by. 
taking a moment to fill in this review sheet. 
Fold the sheet in thirds and seal it so that the 
address on the bottom of the back becomes 
the envelope front. Thank you for helping us! 


2. If you have problems using the program, please describe them here. 


{ 


3. What do you especially like about this program? 


. 4, What do you think the program's weaknesses are? 


5. How can the catalog description be more accurate or comprehensive? 


6. Ona scale of 1 to 10, 1 being “poor” and 10 being “excellent”, please rate the follow- 


ing aspects of this program: 


Easy to use 


Enjoyable 
Self-instructive 
Use (non-game programs) 


{ 


User-oriented (e.g., menus, prompts, clear language) 


Imaginative graphics and sound 


7. Describe any technical errors you found in the user instructions (piease ¢ 
page numbers). 


8. What did you especially like about the user instructions? 


9. What revisions or additions would improve these instructions? 


10. On a scale of 1 to 10, 1 representing “poor” and 10 representing “excellent”, how 
would you rate the user instructions and why? 


11. Other comments about the program or user instructions: 


nn 


rom 


STAMP 


; APX% ATARI Program Exchange 
P.O. Box 3705 
@ 
© santa Ciara, CA 95055 


{seal here} 
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